home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmStringNCopy.z / XmStringNCopy
Encoding:
Text File  |  2003-11-18  |  2.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_S_t_r_i_n_g_N_C_o_p_y    - A compound string function that creates a
  10.       copy of a compound string
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/Xm.h>
  14.  
  15.       XmString XmStringNCopy (ssss1111,,,, nnnnuuuummmm____bbbbyyyytttteeeessss)
  16.            _X_m_S_t_r_i_n_g     ssss1111;
  17.            _i_n_t     nnnnuuuummmm____bbbbyyyytttteeeessss;
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.       _X_m_S_t_r_i_n_g_N_C_o_p_y    creates    a copy of ssss1111 that contains a specified
  21.       number of bytes, including tags, directional indicators, and
  22.       separators.  It then returns the resulting compound string.
  23.       The original strings are preserved.  The space for the
  24.       resulting compound string is allocated within    the function.
  25.       The application is responsible for managing the allocated
  26.       space.  The memory can be recovered by calling _X_m_S_t_r_i_n_g_F_r_e_e.
  27.  
  28.       ssss1111   Specifies the compound string.
  29.  
  30.       nnnnuuuummmm____bbbbyyyytttteeeessss
  31.            Specifies the number of bytes of    ssss1111 to copy.  If    this
  32.            value is    less than the length of    ssss1111, as many bytes as
  33.            possible, but possibly fewer than this value, will be
  34.            appended    to ssss1111 such that    the resulting string is    still
  35.            a valid compound    string.
  36.  
  37.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  38.       Returns a new    compound string.
  39.  
  40.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  41.       _X_m_S_t_r_i_n_g_C_r_e_a_t_e(_3_X) and _X_m_S_t_r_i_n_g_F_r_e_e(_3_X).
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.